home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 22
/
Cream of the Crop 22.iso
/
program
/
tdev10.zip
/
TDE.DOC
< prev
next >
Wrap
Text File
|
1996-09-09
|
20KB
|
484 lines
─┼─────────────────────────────┼─
│ [T]he [D]ecoding [E]ngine │
┼─────────────────────────────┼
├───────■ Version 1.0 ■───────┤
─┼─────────────────────────────┼─
(c) 1995-96 by Alexander Curth - All Rights Reserved!
[ 1.] Introduction
[ 2.] Requirements
[ 3.] Features
[ 4.] Installation
[ 5.] Usage / Usage in Crosspoint
[ 6.] Registering TDE
[ 7.] Disclaimer
[ 8.] Copyright
[ 9.] Trademarks
[10.] Bugreports, Errors & Problems
[11.] PGP-KEY of the Author
[12.] Errorlevels / Usage in batch Programs
[13.] Support-BBS
[ 1.] Introduction to [T]he [D]ecoding [E]ngine (TDE)
─────────────────────────────────────────────────────
TDE was especially designed to decode LARGE Buffers in
USENET-Format (including Subjectlines etc.) or ZCONNECT-Format
(Crosspoint, etc.) which contain lots of encoded Binaries you
can recieve via the Internet! Most Pointprograms and Newsreaders
are able to decode these Binaries, but the decoding routines are
often not complete or not userfriendly or they have problems to
decode multi-part files etc., so I had to write my own Decoder
and here is the result!
TDE is SHAREWARE that means you have to register it, if you use
it after a trial time of 30 days - Thanks!
IMPORTANT NOTE:
───────────────
The Bufferfile has to be in standard PC-TEXT-MODE, that means
that each line has to end with $0D0A !!! (Exception:
Crosspoint-Binaries Files) So PLEASE make sure that your
Bufferfiles are in PC-TEXT-MODE, otherwise TDE will decode
nothing... THIS IS NOT A BUG!
Solution:
o Convert the Bufferfile with an Editor etc. to PC-TEXT-MODE!
(Load the Bufferfile into an Editor and then save it. This
should help!)
o If there are enough requests of REGISTERED users, I will
change this behaviour in one of the future Versions...
================================================================
[ 2.] REQUIREMENTS:
───────────────────
- PC (compatible) running MS-DOS (compatible)
- 286 or higher Processor
- 400KB (or more) free Basemem
- CJPEG.EXE if you want to convert .GIF etc. to .JPG
(CJPEG.EXE is Freeware and can be download in lot's of BBS's)
- OPTIONAL: PKUNZIP.EXE, LHA.EXE, ARJ.EXE, GZIP.EXE and RAR.EXE
to test archive-integrity (Download them from any FTP-Server
or your local BBS, if you don't have them)
- A valid TEMP environment variable
I recommend a Ramdisk (at least 2 MB) to speed up the decoding!
Note:
Disk-Read/Write-Caches (e.g. SMARTDRIVE) or WINDOWS95 will speed
up TDE, too!
TDE HAS BEEN TESTED WITH:
─────────────────────────
Program │ Version
────────────┼───────────────────────────
MS-DOS │ V6.22 & V7.00 (WINDOWS 95)
CROSSPOINT │ V3.11
F-PROT │ V2.24
PKUNZIP │ V2.04g
ARJ │ V2.50a
LHA │ V2.55b
RAR │ V2.00
GZIP │ V1.2.4
CJPEG │ V6.0
================================================================
[ 3.] FEATURES:
───────────────
- Supports UUE, XXE & BASE64 Decoding
- Decodes Buffers up to 9 GIGABYTE!
- Fast (ASM) Decoding-Routines
- Supports automatic & 'intelligent' Errorfixing
(repairs Messages, if possible)
- 100% Crosspoint(XP) compatible
* Removes decoded Messages automaticly from Crosspoint(XP)
- Extracts Crosspoint(XP)-Binaries
- Logfile for Crosspoint(XP)
- Handles up to ten different Bufferfiles and decodes them like
one large Bufferfile
- Automaticly repairs .JPG Files (if possible)
- Decoding handles single files and multi-part files
(EVEN IF THEY ARE RECIEVED NOT IN THE CORRECT ORDER)
- Supports Error-Logging with usefull Descriptions
- Supports automatic detection & renaming of duplicate Files
* Supports automatic conversion of .GFX to .JPG (requires CJPEG)
- Supports automatic testing of ZIP, ARJ, RAR, LZH/LHA, Z archives
- Supports automatic Virusscanning of executeable files
(requires F-PROT)
- Supports Signature-check for:
.JPG.GIF.ZIP.ARJ.MPG.BMP.EXE.VOC.Z.MID.XM.TIF-Files
* Supports automatic testing of JPG pictures
* Supports automatic deletion of identical duplicate Files
(CRC-32 based)
- 'Nice' Statusscreen (;
* Support of sorting/moving the extracted files into subdirs
- LOW REGISTRATION FEE: $25 OR 25,- DM (Updates are for free!)
* = THESE FEATURES ARE ONLY AVAILABLE IN THE REGISTERED VERSION
OF TDE!
IF YOU ARE STILL NOT CONVINCED THAT TDE IS THE BEST AVAILABLE
UUE,XXE,B64 (MIME)-DECODER SO FAR, THEN FEEL FREE TO COMPARE THE
*RESULTS* OF TDE WITH YOUR FAVORITE ONE...
================================================================
[ 4.] INSTALLATION:
───────────────────
- Copy the files TDE.* into a DOS-"PATH" or in a Directory
- Change to the directory where the files TDE.* are located
- Configure TDE with "TDE.EXE /C"
================================================================
[ 5.] USAGE
───────────
- "TDE.EXE /C"
to Configures TDE
- TDE.EXE <BUFFERFILENAME>
to decode all binaries from <BUFFERFILENAME>
- TDE.EXE /L
to process all files (max. 10), which are defined in the file
TDE.LST! (The first line must contain the first bufferfile and
so on...) The first File HAS TO exist, otherwise you will get an
errormessage! All other files given in the list will be skiped,
if they don't exist! All these bufferfiles will be handled and
decoded if they would be "one" bufferfile! (That means even if
parts of a multipart-message are stored in different buffers,
the message would be decoded correctly!) The bufferfiles will
NOT be copied to one large bufferfile on the HD, they will only
be processed like "one" bufferfile!
Here is an example for a TDE.LST file:
-cut-
c:\buffer.10
c:\buffer.11
c:\buffer.12
c:\buffer.13
c:\buffer.14
c:\buffer.15
c:\buffer.16
c:\buffer.17
c:\buffer.18
c:\buffer.19
-cut-
NOTE:
If you don't have TDE in a PATH and if you want to call it from
a batchfile you have to do it this way:
-CUT-
rem You *HAVE TO* change to the TDE-DIRECTORY first!
C:
CD C:\TOOLS\TDE
TDE.EXE %1
-CUT-
USAGE IN CROSSPOINT
───────────────────
As I don't have an english version of Crosspoint, I cannot
describe how to install TDE in the english version of XP! (If
you are interested to install TDE into XP, then read the german
doc! (TDE.DOK) Even if you don't understand german, the pictures
may help you, if not then contact me...)
================================================================
[ 6.] REGISTERING TDE
─────────────────────
The registered version has EXTRA-FEATURES (see above) and is
able to work in batch-mode (there are no Shareware-Screens)
If you have registered TDE once, you will always (*) get the
latest version of TDE (registered to your Name/Company)
PGP-CRYPTED via E-mail for free.
NOTE
────
This service is only available as long as you don't change your
E-mail address or PGP-key! In this case you can re-register for
a lower price: $5 or 5,- DM! (This is necessary, because it
means extra-work for me)
Maybe I will use someday a code-system! In this case you will
not get any longer updates via E-mail, but all registered users
of TDE will get a code! With this code you can register the
Sharewareversion, so you still can update TDE for free!
HOW TO REGISTER TDE
───────────────────
(1)
You *NEED* a PGP-KEY!
- the USER ID has to be in this form:
'REALNAME <your@e-mail.adress>'
- Here a few info's for you, if you don't have a PGP-KEY:
o PGP is free for private use!
o Quick instructions, how to generate a PGP-Key in 5-10 min. ,
will follow in this documentation!
NOTE:
I will ship the REGISTERED VERSION of TDE *ONLY* crypted with
your PUBLIC-PGP-KEY over the Internet (guess why...) In other
words: If you send me money, but no REGISTER.ENG INCLUDING YOUR
PGP-KEY, then don't expect to recieve anything from me in
return, so please follow the rules!
IF YOU ALLREADY HAVE SUCH A PGP-KEY, THEN GOTO (2) ELSE
CONTINIUE READING
- Download PGP263.ZIP or PGP263I.ZIP from
ftp://ftp.ifi.uio.no/pub/pgp/
ftp://ftp.ox.ac.uk/pub/crypto/pgp/
ftp://ftp.dsi.unimi.it/pub/security/crypt/PGP/
ftp://ftp.informatik.uni-hamburg.de/pub/virus/crypt/pgp/
other ftp servers or one of your local BBS's
- Install the PGP-Program
- Create your SECRET & PUBLIC PGP-KEY(S) with:
"PGP -kg" and follow the instructions on the screen!
- Select a Key with any size (I recommend 1024)
- Enter your REALNAME and your E-MAIL address like in the given
example, if you are prompted to enter your USER ID!
- REMEMBER THE PASS PHRASE YOU ENTER!!!
(better do not write it down!)
IMPORTANT
─────────
STORE YOUR SECRET KEY ON A SAFE PLACE AND NEVER GIVE YOUR PASS
PHRASE TO ANYBODY ELSE!
- Extract your PUBLIC KEY from the keyring with:
"PGP -kxa <your user ID> MYKEY.ASC"
If your REALNAME is e.g. JIM SMITH then you have to enter:
"PGP -kxa JIM mykey.asc"
The file MYKEY.ASC will contain your PUBLIC PGP-KEY, that you
have to append to the REGISTER.ENG!!!
(These are just QUICK docs how to create your PGP-Key(s), so
please read the PGP.DOC if you want to know more about PGP and
do not ask me, thanks!)
(2)
Fill out the REGISTER.ENG and append your PUBLIC-PGP-KEY to the
REGISTER.ENG
(3)
Send the REGISTER.ENG to my E-Mail-Address!
(4)
The registration fee (**) is $25 (US DOLLAR) or 25,- DM (German
currency)
Payment:
Unfortunately my bank charges me fees for foreign EuroCheques
and for foreign remittance orders, so you have to add $15 (US$)
or 15,- DM to the registration fee of TDE if you choose one of
these modes of payment! (You have to pay $40 (US$) or 40,- DM)
a) REMITTANCE:
Bank : BERLINER SPARKASSE , GERMANY
Bank code : 100 500 00
Account no. : 240369394
Reciever : ALEXANDER CURTH
Attn : YOUR E-MAIL-ADDRESS
b) INTERNATIONAL POSTAL MONEY ORDER:
You have to go to your local post office and tell them that you
want to send someone in Germany xx,- DM (German currency). They
will give you a form to fill out, the postal clerk will look at
the conversion table and you will pay the equivalent in your own
currency. Some days later my postman brings me the money.
c) SEND IT TO MY ADDRESS:
ALEXANDER CURTH
EMDENER STR. 30
10551 BERLIN / GERMANY
- as CASH / only in DM (German currency) or US$ (BILLS!)
- as an EUROCHEQUE / only in DM (German currency)
NOTE
────
Do no forget to write your NAME and E-MAIL-ADDRESS at the
backside of the envelope and please make sure that the
money/cheque is not visible through the envelope - Thanks!
(5)
AS SOON AS I RECIEVE YOUR MONEY, I WILL SEND THE REGISTERED COPY
CRYPTED WITH YOUR PUBLIC-PGP-KEY TO YOUR E-MAIL-ADRESS! (If you
do not get your registered copy within 20 days, after you have
send me the money and the REGISTER.ENG, then contact me!)
(6)
If you recieve the mail from me that contains YOUR REGISTERED
COPY of TDE, then decrypt it with:
- "PGP -p <messagefilename>"
- Enter your PASS PHRASE
- Extract the ZIP and copy the TDE.EXE over the previous Version
(**) ALL PRICES ARE *ONLY* VALID IF YOU WANT TO USE TDE FOR
PRIVATE REASONS! IF YOU WANT TO USE TDE IN A
COMMERCIAL-BBS, COMPANY, ETC. THEN YOU HAVE TO PAY $200 (US
DOLLAR) OR 200,- DM! IF YOU WANT TO REGISTER 10 OR MORE
COPIES OF TDE, THEN ASK ME FOR SPECIAL PRICES!
================================================================
[ 7.] DISCLAIMER
────────────────
THIS SOFTWARE IS PROVIDED "AS IS". THERE IS NO WARRANTY, WETHER
EXPRESS NOR IMPLIED. THE AUTHOR DOES NOT ACCEPT ANY LIABILITIES
WITH RESPECT TO THIS PROGRAM. USE THIS PROGRAM ON YOUR OWN RISK!
IF YOU DON'T AGREE WITH THIS, THEN DELETE IT!
================================================================
[ 8.] COPYRIGHT
───────────────
You are allowed to copy the *SHAREWARE-VERSION* of TDE for free.
You may distribute the program to others as long as you do not
charge any fee and as long as there are no changes made with the
program, this documentation and as long as the package
TDE-Vxx.ZIP is complete.
================================================================
[ 9.] TRADEMARKS
────────────────
ARJ is copyright 1990-96 by ARJ Software
CROSSPOINT (XP) is copyright by Peter Mandrella
F-PROT is copyright by Frisk Software International
GIF is a service mark of CompuServe Incorporated
GZIP is copyright 1992-1993 by Jean-loup Gailly
LHA is copyright 1988-92 by Haruyasu Yoshizaki
MS-DOS is a trademark of Microsoft Corporation
PGP is copyright 1990-1994 by Philip Zimmermann
PKZIP/PKUNZIP are copyright 1989-1993 PKWARE Inc.
RAR is copyright 1993-96 by Eugene Roshal
WINDOWS 95 is a trademark of Microsoft Corporation
================================================================
[10.] BUG-REPORTS
─────────────────
All decoded files with errors will be stored in
<EXTRACTPATH>\_ERROR! The Error-Descriptions are stored in the
file <EXTRACTPATH>\_ERROR\!ERROR.LOG
PLEASE NOTE:
Not all recognized errors are 'BUGS' of TDE!!! So please check
*first* if the error-description in the !ERROR.LOG is valid! If
not and if you are able to decode the file with another decoder
errorfree or if you are able to decode the file after you have
done some changes in the buffer, then you can say it's a 'BUG'
in TDE and *ONLY IN THIS CASE* I would really appriciate it, if
you contact me (send me the !ERROR.LOG and the message - if it
is not larger than 250 Kb) Don't worry about the contents of the
message (Picture, Text, Sound, etc.) I really don't care as long
as it is not of illegal nature!
If PKUNZIP, ARJ, LHA/LZH, RAR or F-PROT returns an errorlevel of
255 then there are two possible reasons:
- there is an error in the CFG-File! (check the path etc. with
"TDE /C")
- there is too less free base-memory to execute the
test-program! (Try to increase your free memory or turn the
option off!)
If TDE crashes/hangs then you should do this:
- Enter the DOS-Shell and type "SET TDEDEBUG=ON" + <CR>
- Let TDE decode the buffer with the error again!
- Note the Subject (the red line) of the message wich causes TDE
to crash!
- Search for the message with the Subject in your mailer
- Extract this message (if multipart: all parts)
- Decode this message/s
- If the error still appears, then send the message/s to me!
(incl. Header & Body!)
- If the error appears not again, then try to find the message
that causes the error and send it to me!
If you discover other BUGS, then send me a detailed
error-description, or tell me what I have to do to reproduce the
error! (if you can...)
PLEASE SEND BUG-REPORTS & SUGGESTIONS TO:
alexc@kitembx.in-berlin.de
Ps: If you report bugs, then please let me know which version of
TDE you use!
THANKS!
================================================================
[11.] PGP-KEY OF THE AUTHOR
───────────────────────────
-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: 2.6.3i
mQCNAzEvkR8AAAEEANQMAv9CcBLBgA58qMvrbLfQTuuR8hkS1WQUh17aqMdu42OU
G9kqmEzRMd5t2fdF+HIlHBpEqlPmhtRQx1z0z1Axt5c0B5sl+RWfQvvZQbBeFSMP
lKbPDOFM8NgVmjp1Md4gCaNHNmjcNGT2VN8X/cqJkFILPyY1wL6FWFlm32tZAAUR
tCxBbGV4YW5kZXIgQ3VydGggPGFsZXhjQGtpdGVtYnguaW4tYmVybGluLmRlPg==
=fGrM
-----END PGP PUBLIC KEY BLOCK-----
================================================================
[12.] ERRORLEVELS / (FOR USAGE IN BATCH PROGRAMS)
─────────────────────────────────────────────────
ERRORLEVEL: 1 = no Error
ERRORLEVEL: 0 = fatal Error
================================================================
[13.] SUPPORT-BBS
─────────────────
You can download the latest Sharewareversion of TDE for free at:
Kiteflyer BBS Berlin
+49-30-6690016 ISDN X75
+49-30-6690017 ISDN X75 / Analog Zyxel 19k2
+49-30-6690018 Analog USR 33K6
Online Account
─────────────-
Login : TDE <CR>
Password: tde (case sensitive!) <CR>
then enter:
files <CR>
cd dos tools <CR>
list TDE* <CR>
down TDE-Vxx.zip <CR>
================================================================
Ps:
Sorry for my bad english! Feel free to send me a corrected
TDE.DOC!
That's all!